home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / ab20 / ab20_archive / languages / assembly / powervisor_113.lzh / docs / InstallingPowerVisor < prev    next >
Text File  |  1992-02-07  |  31KB  |  840 lines
  1. *----------------------------------*
  2. * Tutorial : installing PowerVisor * Fri Feb  7 15:04:41 1992
  3. *----------------------------------*
  4.  
  5. ===================== Commands used in this tutorial =========================
  6.  
  7.    mode        Set PowerVisor preferences
  8.    prefs       Set preferences
  9.    screen      Set PowerVisor on another screen
  10.  
  11. ===================== Functions used in this tutorial ========================
  12.  
  13.  
  14. ============================== Introduction ==================================
  15.  
  16. At this moment (after you have read the 'GettingStarted', the 'Expressions'
  17. and the 'Screen' chapters) you are probably ready to ²customize PowerVisor.
  18. This is a complex business and you will probably have to change some
  19. parameters later when you use PowerVisor.
  20.  
  21.  
  22. =========================== The 'mode' command ===============================
  23.  
  24. With the 'mode' command you can set some parameters. The 'mode' command
  25. expects any number of keywords. These keywords need not be in any
  26. particular order.
  27. The following keywords are supported :
  28.  
  29.    pal         set ¹monitor to ¹pal (only AmigaDOS 2.0)
  30.                the ¹non-interlaced resolution is 640x256 and the
  31.                ¹interlaced resolution is 640x512. This resolution will be
  32.                bigger if you use ¹overscan.
  33.    ntsc        set monitor to ¹ntsc (only AmigaDOS 2.0)
  34.                non-interlaced : 640x200
  35.                interlaced : 640x400
  36.    vga         set monitor to ¹vga (only AmigaDOS 2.0 and new denise)
  37.                non-interlaced : 640x480
  38.                interlaced : 640x960
  39.    viking      set monitor to ¹a2024 (only AmigaDOS 2.0)
  40.                resolution : 1024x1008
  41.  
  42.    lace        use ¹interlace
  43.    nolace      no interlace (default)
  44.  
  45.    fancy       use ²two bitplanes for the PowerVisor screen (default)
  46.    nofancy     use only ²one bitplane
  47.  
  48.    sbottom     include the ²size gadget in the ²bottom border. This means that
  49.                you loose a line but you gain some columns (default)
  50.    nosbottom   include the size gadget in the ²right border of the window.
  51.                You loose some columns but you gain a line or so
  52.  
  53.    space       add a space after a ²snapped word (default)
  54.    nospace     don't add a space. Simply snap the word as it is
  55.  
  56.    lonespc     snap a space if you click on an empty place in a logical
  57.                window
  58.    nolonespc   don't snap a space (default)
  59.  
  60.    shex        ³show hex words when ²disassembling instructions. The
  61.                disadvantage is that these words could overwrite the right
  62.                side of the ¹symbolname if present (default)
  63.    noshex      don't show hex words. Symbols will be completely visible
  64.  
  65.    dec         display all printed ¹integers as ²decimal only
  66.    hex         display all printed integers as ²hexadecimal only
  67.    hexdec      first display hex, than display decimal (default)
  68.  
  69.    more        enable ²-MORE- check for the 'Main' ²logical window (default)
  70.    nomore      disable -MORE- check
  71.  
  72.    auto        perform an ²automatic list whenever the ²current list changes
  73.    noauto      don't do this (default)
  74.  
  75.    byte        ²list memory as ¹bytes (for the 'memory' command)
  76.    word        list memory as ¹words
  77.    long        list memory as ¹longs (default)
  78.    ascii       list memory as ¹ascii
  79.  
  80.    fb          ¹feedback each command as it is typed in by the user on
  81.                the current logical window (default)
  82.    nofb        don't do this
  83.  
  84.    patch       ¹patch the Exec AddTask function. When this function is
  85.                patched by PowerVisor ¹crashtrapping will work better
  86.                for all new tasks created after the patch is applied.
  87.                This is recommended if you use ²resident breakpoints
  88.                (see the 'Debug' file). Note that it is not safe to
  89.                run other debuggers (like ¹CodeProbe or ¹MonAm) when
  90.                the patch is applied. They will probably crash when
  91.                you try to trace with them. There will (probably) be
  92.                no problems if you start the other debugger and load
  93.                the debug program with this debugger BEFORE you
  94.                apply the patch (before you start PowerVisor or before
  95.                you type 'mode patch'). (default)
  96.    nopatch     Don't patch the ²Exec AddTask function. When the ¹AddTask
  97.                function is not patched, PowerVisor will trap a crash
  98.                a bit later (too late if you plan to use resident
  99.                breakpoints). With the patch applied PowerVisor traps
  100.                crashes just on the spot while if the patch is not
  101.                applied PowerVisor will only trap the crash just before
  102.                the ¹guru would normally arrive (you will even have to
  103.                press 'cancel' on the ²'task-held' requester before
  104.                PowerVisor notices the crash). But 'mode nopatch' is
  105.                the only safe way to run ²other debuggers concurrently
  106.                with PowerVisor.
  107.  
  108.    intui       if this option is set, PowerVisor will also open a
  109.                physical window (or Intuition window) everytime you
  110.                open one of the standard logical windows ('Extra',
  111.                'Debug', ...) with the standard commands ('xwin',
  112.                'dwin', ...) (not with 'openlw'). This is useful if
  113.                you prefer to work with Intuition windows instead of
  114.                PowerVisor logical windows. The logical window
  115.                is of course opened in this physical window (with the
  116.                same name).
  117.    nointui     Simply open each standard logical window in the 'Main'
  118.                physical window (default)
  119.  
  120.  
  121. Example, to set everything other than default you can use :
  122.  
  123. < mode lace fancy nospace lonespc noshex dec nomore auto byte nofb nopatch
  124. <      intui <enter>
  125.  
  126. All the parameters set with the 'mode' command will be saved with the
  127. 'saveconfig' command (see later).
  128.  
  129.  
  130. =========================== The 'prefs' command ==============================
  131.  
  132. Using the 'prefs' command you can install some additional parameters.
  133. All parameters installable with the 'prefs' command will be saved when
  134. you use 'saveconfig'.
  135.  
  136.  
  137. =============== The maximum number of lines in the history ===================
  138.  
  139. Using 'prefs history' you can get or set the maximum number of lines in the
  140. history. The default is 20.
  141.  
  142. < prefs history <enter>
  143. > 00000014 , 20
  144.  
  145. You can set another value with :
  146.  
  147. < prefs history 500 <enter>
  148.  
  149. Note that the ²history buffer is dynamic. If there are 10 lines in the history
  150. buffer you only loose memory for 10 lines even if the maximum number of lines
  151. is 500.
  152.  
  153. The command also clears the history buffer.
  154.  
  155.  
  156. =========================== Some standard keys ===============================
  157.  
  158. Using 'prefs key' you can get or set ¹keycodes for standard keys. The
  159. following keys are supported :
  160.  
  161.    nr name                 default key           code    qualifier
  162.    -------------------------------------------------------------------------
  163.    0  interrupt key        <esc>                 045     0
  164.    1  hot key              <r-shift>+<r-alt>+'/' 03A     022
  165.    2  pause key            <r-alt>+<help>        05F     020
  166.    3  cycle active logwin  <tab>                 042     0
  167.    4  history up           <arrow up>            04C     0
  168.    5  history down         <arrow down>          04D     0
  169.  
  170. You can look at the current values with :
  171.  
  172. < prefs key 2 <enter>
  173. > 005F 0020
  174.  
  175. Or you can set it to other values with :
  176.  
  177. < prefs key 0 16 0 <enter>
  178.  
  179. This command will set the interrupt key to the 'q' key (or the 'a' key
  180. if you have an AZERTY keyboard). This is only an example. I recommend
  181. that you choose better keys :-)
  182.  
  183. Here are some codes that are often used :
  184.  
  185.    <esc>                      045
  186.    <tab>                      042
  187.    <F1>                       050
  188.    .                          .
  189.    .                          .
  190.    .                          .
  191.    <F10>                      059
  192.    <backspace>                041
  193.    <help>                     05F
  194.    <del>                      046
  195.    <up>                       04C
  196.    <down>                     04D
  197.    <left>                     04F
  198.    <right>                    04E
  199.    <return>                   044
  200.    <enter> (numeric keypad)   043
  201.  
  202. Here are the ¹qualifers. You must add two qualifiers if you want to use
  203. a combination :
  204.  
  205.    Left shift              0001
  206.    Right shift             0002
  207.    Capslock                0004  (this one is ignored by PowerVisor)
  208.    Control                 0008
  209.    Left alt                0010
  210.    Right alt               0020
  211.    Left Amiga              0040
  212.    Right Amiga             0080
  213.  
  214.  
  215. ===================== Setting the startup screen size ========================
  216.  
  217. With 'prefs screen' you can define the width and height of the PowerVisor
  218. screen. If you have AmigaDOS 2.0 you can use any size for the screen. If
  219. this size is big you can scroll by moving the mouse out of the visible part
  220. of the screen.
  221.  
  222. The default is (65535,65535) (or (-1,-1) as words).Which means that
  223. PowerVisor will take the default width and height for the screen.
  224.  
  225. < prefs screen <enter>
  226. > -1 -1
  227.  
  228. For example, to make the screenheight equal to 1024 use the following
  229. command :
  230.  
  231. < prefs screen -1 1024 <enter>
  232.  
  233. You need to quit PowerVisor and start it again to see the result of this
  234. command.
  235.  
  236.  
  237. ====================== Setting the stack fail level ==========================
  238.  
  239. With 'prefs stack' you can set or get the amount of ¹stackspace left before
  240. PowerVisor will halt the task and give a warning (only if account is on
  241. with the 'account' command).
  242. The default value is 40.
  243.  
  244. < prefs stack <enter>
  245. > 00000028 , 40
  246.  
  247. Change it with :
  248.  
  249. < prefs stack 80 <enter>
  250.  
  251. Be careful not to make it too big, or else all tasks will be stopped even
  252. if nothing is wrong.
  253.  
  254.  
  255. ================ Setting default logical window parameters ===================
  256.  
  257. Using 'prefs logwin' you can set or get default parameters for the standard
  258. logical windows ('Main', 'Extra', 'Refresh', 'Debug', 'Rexx', 'PPrint' and
  259. 'Source').
  260.  
  261. Four values are remembered for each ³standard logical window :
  262.  
  263.    - the ³number of columns
  264.        - if 0 we scale the number of columns to the visible size at the
  265.          moment the logical window is created. After that the number of
  266.          columns is fixed
  267.        - if -1 we use horizontal autoscale. The number of columns is adapted
  268.          to the visible size everytime the horizontal visible size changes.
  269.          The disadvantage of this is that the logical window is cleared
  270.        - every other value sets a fixed number of columns
  271.    - the ³number of rows
  272.        - (like the number of columns)
  273.    - the ²flag mask
  274.    - the flag values in this mask
  275.  
  276. The following flags are supported (also see the 'Screen' chapter) :
  277. (bit 0/bit 1)
  278.    -MORE- disable/enable      4
  279.    top-visible/real-top       32
  280.    statusline on/off          64
  281.    interrupt on/off           128
  282.    auto output snap           256
  283. All other bits are used or reserved and should not be used in the mask.
  284.  
  285. For example. To set the ²-MORE- check off, the statusline off and leave
  286. all other flags as default you can use :
  287.    mask  = 4+64
  288.    value = 64
  289.  
  290. Or with -MORE- check on :
  291.    mask  = 4+64
  292.    value = 4+64
  293.  
  294. The following default values are used when a logical window is opened :
  295.    -MORE- disabled
  296.    ¹Interrupt/Pause enabled
  297.    ²Home position is top-visible
  298.    ²Status line on
  299.    ³Auto Output Snap off
  300.  
  301. The standard logical windows have the following defaults (Note that the
  302. -MORE- setting of the 'Main' logical window is dependent on the
  303. 'mode' command) :
  304.  
  305.    - Main      (0,0,160,0)
  306.                number of columns and rows is set to a fixed value. This value
  307.                is the maximum number of columns and rows at the time the
  308.                logical window is created.
  309.  
  310.                Interrupt/Pause enabled
  311.                Home position is top-visible
  312.                Auto Output Snap is on
  313.  
  314.    - Extra     (0,0,160,0)
  315.                number of columns and rows is set to a fixed value. This value
  316.                is the maximum number of columns and rows at the time the
  317.                logical window is created.
  318.  
  319.                Interrupt/Pause enabled
  320.                Home position is top-visible
  321.                Auto Output Snap is on
  322.  
  323.    - Refresh   (0,50,160,160)
  324.                the number of columns is set to a fixed value. This value is
  325.                the maximum number of columns at the time the logical window
  326.                is created. The number of rows is fixed and always set to
  327.                50.
  328.  
  329.                Interrupt/Pause disabled
  330.                Home position is real-top
  331.                Auto Output Snap is off
  332.  
  333.    - Debug     (90,42,160,160)
  334.                the number of columns is fixed and set to 82. The number of
  335.                rows is fixed and set to 42.
  336.  
  337.                Interrupt/Pause disabled
  338.                Home position is real-top
  339.                Auto Output Snap is off
  340.  
  341.    - Rexx      (0,50,160,128)
  342.                the number of columns is set to a fixed value. This value is
  343.                the maximum number of columns at the time the logical window
  344.                is created. The number of rows is fixed and always set to
  345.                50.
  346.  
  347.                Interrupt/Pause disabled
  348.                Home position is top-visible
  349.                Auto Output Snap is off
  350.  
  351.    - PPrint    (0,50,160,128)
  352.                the number of columns is set to a fixed value. This value is
  353.                the maximum number of columns at the time the logical window
  354.                is created. The number of rows is fixed and always set to
  355.                50.
  356.  
  357.                Interrupt/Pause disabled
  358.                Home position is top-visible
  359.                Auto Output Snap is off
  360.  
  361.    - Source    (-1,-1,160,160)
  362.                the number of columns and rows are autoscalable.
  363.  
  364.                Interrupt/Pause disabled
  365.                Home position is real-top
  366.                Auto Output Snap is off
  367.  
  368.  
  369. To get the defaults :
  370.  
  371. < prefs logwin debug <enter>
  372. > 90 42 00A0 00A0
  373.  
  374. To set other defaults :
  375.  
  376. < prefs logwin debug 100 50 160 160 <enter>
  377.  
  378. You need to quit PowerVisor and start it again to see the result of this
  379. command when applied to the 'Main' logical window. For all other logical
  380. windows you can simple close/open them to see the changes. You can also
  381. use the 'setflags' command to set the flags for a logical window
  382. immediatelly (also for 'Main'), and the 'colrow' command to set the
  383. ³number of columns and rows immediatelly.
  384.  
  385.  
  386. ===================== The default commandline length =========================
  387.  
  388. With 'prefs linelen' you can set or get the maximum length of the
  389. ²stringgadget commandline. This is also the maximum number of characters that
  390. may be used in ¹scripts (not ²ARexx scripts). The default is 400. Note that
  391. PowerVisor uses 800 bytes with a linelength of 400 (always double).
  392.  
  393. To get the default :
  394.  
  395. < prefs linelen <enter>
  396. > 00000190 , 400
  397.  
  398. To set another value :
  399.  
  400. < prefs linelen 1000 <enter>
  401.  
  402. You need to quit PowerVisor and start it again to see the result of this
  403. command.
  404.  
  405.  
  406. ========================= Some debug preferences =============================
  407.  
  408. With 'prefs debug' you can set or get some preferences for the ¹debugger.
  409. The first argument is the ³number of instructions to disassemble after
  410. each ¹trace and the second argument is 0 or 1 if you want the disassemble
  411. the ²previous instruction (no or yes resp.) after each trace. The values
  412. set with this command are also used by the ²fullscreen debugger.
  413. Default is 5,1. This means 5 instructions and yes, disassemble the previous
  414. executed instruction too.
  415.  
  416. < prefs debug <enter>
  417. > 00050001 , 327681
  418.  
  419. You can set other values using :
  420.  
  421. < prefs debug 15 0 <enter>
  422.  
  423. (15 instructions and no previous instruction)
  424.  
  425.  
  426. =============================== Debug mode ===================================
  427.  
  428. Using 'prefs dmode' you can set the information that should be displayed
  429. after a trace. This parameter is not used by the ²fullscreen debugger since
  430. the fullscreen debugger always shows all information.
  431.  
  432. You can set the following parameters :
  433.  
  434.    n        show no info at all. This is useful when you are using the
  435.             fullscreen debugger and you do not want to be disturbed
  436.             by output on the current logical window
  437.    r        show only ¹registers
  438.    c        show only code (using the format describe in the previous
  439.             section)
  440.    f        show registers and code (default)
  441.  
  442. For example :
  443.  
  444. < prefs dmode n <enter>
  445.  
  446.  
  447. ============================= Installing pens ================================
  448.  
  449. Every color you see on the PowerVisor screen or window can be changed.
  450. You can do this with the 'color' command. This command changes the
  451. RGB values for a color. The disadvantage is of course that this change
  452. affects all uses of that color. But don't worry, PowerVisor gives you
  453. the option to change virtually every color. This is because PowerVisor
  454. uses a pen array (the idea is stolen from AmigaDOS 2.0) to access each
  455. color. Using 'prefs pens' you can view or change this pen array.
  456.  
  457. There are 48 ¹pens. The first 24 are for ²fancy screens (2 or more
  458. bitplane screens) and the last 24 are for 1 bitplane screens. Only the first
  459. 21 pens are used for both the fancy and no-fancy screens. The other pens
  460. are reserved for future use.
  461.  
  462. With no arguments this command lists all pens on two lines: the
  463. first line containing all pens for fancy screens and the second
  464. line for no-fancy screens.
  465.  
  466. Here follow the currently defined pen numbers and there default
  467. color values. Add 24 to the pen number to get the no-fancy screen
  468. pen number :
  469.  
  470.    nr    name                 default fancy     default no-fancy
  471.    -------------------------------------------------------------
  472.    0     BoxBackground        0                 0
  473.    1     LogWinBackground     0                 0
  474.    2     NormalText           1                 1
  475.    3     PrompText            1                 1
  476.    4     StatusTextInActive   1                 1
  477.    5     StatusTextActive     2                 0
  478.    6     InActiveBar          0                 0
  479.    7     ActiveBar            3                 1
  480.    8     TopLeft3D            2                 1
  481.    9     BottomRight3D        1                 1
  482.    10    BoxLine              1                 1
  483.    11    PositionBox          0                 0
  484.    12    TopLeftBox           1                 1
  485.    13    BottomRightBox       2                 1
  486.    14    PositionIndicator    3                 1
  487.    15    SGInActiveText       3                 1
  488.    16    SGInActiveBackground 0                 0
  489.    17    SGActiveText         1                 1
  490.    18    SGActiveBackground   0                 0
  491.    19    HilightPen           2                 0
  492.    20    HilightBackPen       0                 1
  493.  
  494. (To see the effect of pen changes you should open/close your windows first.
  495. For most pens the effect is immediatelly visible and for some pens (like
  496. the SG... pens) the change is only visible after exiting PowerVisor)
  497.  
  498.  
  499. The 'BoxBackground' pen is used to draw the background of a box (see the
  500. 'Screen' tutor file for more information about boxes). This pen color is
  501. usually the same as the 'LogWinBackground' pen explained below. If you
  502. insist on using another value you will see a small border in each of your
  503. logical windows. This small border will grow if you make the number of
  504. columns and lines in the logical window smaller than the visible size
  505.  
  506. The 'LogWinBackground' pen is the background pen used in a logical window.
  507. This pen is only used on places where characters CAN appear. This explains
  508. the small border that you see when you change the 'BoxBackground' pen. The
  509. small border is the region of the logical windows where no characters can
  510. appear
  511.  
  512. The 'NormalText' pen is used to print all text in logical windows. This
  513. pen should be different from 'LogWinBackground', otherwise you will see
  514. nothing
  515.  
  516. The 'PromptText' pen is used to print the prompt (the current list
  517. indicator). This pen should be different from 'BoxBackground', otherwise
  518. the prompt will be invisible
  519.  
  520. The 'StatusTextInActive' pen is used to print the name of the logical
  521. window in the logical window bar when the logical window is inactive
  522. (the active logical window is the window where you can scroll)
  523.  
  524. The 'StatusTextActive' pen is used to print the name of the logical window
  525. in the logical window bar when the logical window is active
  526.  
  527. The 'InActiveBar' pen is used as background for the logical window bar
  528. when the logical window is inactive. This pen should be different from
  529. 'StatusTextInActive'
  530.  
  531. The 'ActiveBar' pen is used as background for the logical window bar
  532. when the logical window is active. This pen should be different from
  533. 'StatusTextActive'
  534.  
  535. The 'TopLeft3D' and 'BottomRight3D' pens are used for all 3D borders
  536. (at this moment only the border round the logical window bar uses these
  537. pens). The 'TopLeft3D' pen should be a light color and 'BottomRight3D'
  538. should be dark. This is to ensure the raised 3D effect of the border
  539.  
  540. The 'BoxLine' pen is used to draw the line between horizontally arranged
  541. logical windows. It should be different from 'BoxBackground'
  542.  
  543. The 'PositionBox' pen is used to draw the background of the position
  544. indicator at the right of the logical window bar
  545.  
  546. The 'TopLeftBox' and 'BottomRightBox' pens are used for the recessed
  547. 3D border round the position indicator. Note that this border is
  548. dithered when PowerVisor is in no-fancy mode
  549.  
  550. The 'PositionIndicator' pen is used for the little knob in the
  551. position indicator. This pen should be different from the 'PositionBox'
  552. pen
  553.  
  554. 'SGInActiveText' is used for the color of the text when the stringgadget
  555. is inactive (only AmigaDOS 2.0)
  556.  
  557. 'SGInActiveBackground' is used for the color of the stringgadget background
  558. when it is inactive (only AmigaDOS 2.0)
  559.  
  560. 'SGActiveText' is used for the color of the text when the stringgadget
  561. is active (only AmigaDOS 2.0)
  562.  
  563. 'SGActiveBackground' is used for the color of the stringgadget background
  564. when it is active (only AmigaDOS 2.0)
  565.  
  566. 'HilightPen' is used for the color of the hilighted text (used by the
  567. fullscreen debugger for example)
  568.  
  569. 'HilightBackPen' is the background color for hilighted text. With this
  570. you can achieve the effect of inverse video if you want
  571.  
  572.  
  573. Example :
  574.  
  575.  
  576. < prefs pens <enter>
  577. > 0 0 1 1 1 2 0 3 2 1 1 0 1 2 3 3 0 1 0 2 0 0 0 0
  578. > 0 0 1 1 1 0 0 1 1 1 1 0 1 1 1 1 0 1 0 0 1 0 0 0
  579.  
  580.  
  581. Change the color of normal text to blue (or the color installed on
  582. color 3) :
  583.  
  584. < prefs pens 2 3 <enter>
  585.  
  586.  
  587. ======================== Setting the default font ============================
  588.  
  589. With the 'setfont' command it is possible the set the font for one logical
  590. window. But this command only sets the font for the text in the logical
  591. window. The font is not set for the size bar. With the 'prefs font' command
  592. you can set the default font used by everything in PowerVisor. This default
  593. font is used by all logical windows (except when you 'setfont' them with
  594. another font), the stringgadget, the screen titlebar and the size bars
  595. between all logical windows.
  596.  
  597.  
  598. Example :
  599.  
  600.  
  601. < prefs font <enter>
  602. > topaz.font : 8 0 0
  603.  
  604. This is the default (topaz.font, size 8, style 0 and flags 0)
  605.  
  606. If you want to use topaz.font 9 for example you can use :
  607.  
  608. < prefs font topaz.font 9 0 0 <enter>
  609. < saveconfig <enter>
  610. < quit <enter>
  611.  
  612. CLI< run pv <enter>
  613.  
  614. And the default font for everything will be topaz 9.
  615.  
  616.  
  617. ============================= The config file ================================
  618.  
  619. All parameters set with the 'mode' or 'prefs' command can be saved using
  620. the 'saveconfig' command. This command will create a file called
  621. ¹s:PowerVisor-config. If this file is not present when PowerVisor starts,
  622. the default values are used.
  623.  
  624. Example :
  625.  
  626. < saveconfig <enter>
  627.  
  628.  
  629. ======================= Other installation factors ===========================
  630.  
  631. There are still other things that you can install. But these things are not
  632. saved in the s:PowerVisor-config file. If you want to set them automatically
  633. you'll have to include the right commands in the ¹s:PowerVisor-startup file.
  634. See the 'Scripts' tutor file for more information about scripts in general.
  635.  
  636.  
  637. =========================== Setting the colours ==============================
  638.  
  639. With the 'color' command you can set the default ¹colours for the PowerVisor
  640. screen.
  641.  
  642. Example, to get the ²3D colours used by ²Workbench 2.0 when you have opened
  643. PowerVisor on a ²2 bitplane screen you can use :
  644.  
  645. < color 0 10 10 10 <enter>
  646. < color 1 0 0 0 <enter>
  647. < color 2 15 15 15 <enter>
  648. < color 3 6 7 9 <enter>
  649.  
  650. If you use these values the 3D design (the ¹statusline) will be very nice.
  651.  
  652. You can't use the 'color' command when PowerVisor is on another screen.
  653.  
  654.  
  655. ========================= Setting alias commands =============================
  656.  
  657. Using the ¹¹'alias' command you can ³define other commands.
  658. See the 'CommandReference' file for more details.
  659. Note that there are already a lot of predefined aliases in the
  660. s:PowerVisor-startup file. See the 'Aliases' reference file for more
  661. information about these aliases.
  662.  
  663.  
  664. Some extra examples :
  665.  
  666.  
  667. < alias lfd 'loadfd [] fd:[]_lib.fd' <enter>
  668.  
  669. You have defined a command 'lfd'. When you type something like :
  670.  
  671. < lfd exec <enter>
  672.  
  673. The command will be expanded and the following command will be executed :
  674.  
  675. < loadfd exec fd:exec_lib.fd <enter>
  676. > ...
  677.  
  678. This command loads an ¹fd-file in memory.
  679.  
  680.  
  681. < alias opwin '{openpw [] 0 0 300 200;openlw [] [] 80 40}' <enter>
  682.  
  683. Defines an alias 'opwin' that opens a ²physical window and a ²logical window
  684. in this physical window.
  685.  
  686.  
  687. If you use the group operator in the alias string, alias expansion will
  688. be done again. So you can use aliases in an alias allowing for recursive
  689. alias definitions. The following two commands define a new command 'fact'
  690. to compute the facultaty of its argument :
  691.  
  692. < alias _fact 'void if(([])==1,1,{_fact ([])-1}*([]))' <enter>
  693. < alias fact 'disp {_fact []}' <enter>
  694.  
  695. < fact 5 <enter>
  696. > 00000078 , 120
  697.  
  698. '_fact' is the ²recursive alias. 'fact' is only provided to give a more
  699. command like syntax. Note that this recursion is limited by both
  700. the available stack (PowerVisor will give an error when the end of
  701. the stack is getting close) and the maximum length of the commandline
  702. (you can increase this maximum length with the 'prefs' command).
  703.  
  704.  
  705. If you want to use [] in the string you can use quotes :
  706.  
  707. < alias test 'print \\[\\]' <enter>
  708.  
  709. The first ²string expansion leads to the definition of 'test' as the command
  710. 'print \[\]'. The expansion done by 'print' leads to the correct execution.
  711.  
  712.  
  713. ======================= Attaching commands to keys ===========================
  714.  
  715. Using the 'attach' command you can ³³attach a command to a key (such
  716. a key with a command attached to it is called a macro)
  717.  
  718.  
  719. Example :
  720.  
  721.  
  722. To add the 'list' command to the <F1> key you can use :
  723.  
  724. < attach 'list' 050 0 <enter>
  725.  
  726. If you press <F1> 'list' is put on the stringgadget and an enter is
  727. simulated (this means that 'list' is also put in the history buffer).
  728.  
  729. If you do not want the stringgadget to be disturbed you can use :
  730.  
  731. < attach 'list' 050 0 e <enter>
  732.  
  733. With 'remattach' you can remove ¹macros.
  734.  
  735.  
  736. ================================== Files =====================================
  737.  
  738. If you like you can change the ²online help file. Read the ¹'QuickHelp'
  739. document for more information about the quickhelp file format.
  740.  
  741. Note that if you start a line in the online help file with a '¬' it will
  742. not be printed on screen (with the 'help' command).
  743.  
  744. When you have changed the online help file you must update PowerVisor-ctrl
  745. with the following command :
  746.  
  747. CLI< makehelp pv:c/PowerVisor-help pv:c/PowerVisor-ctrl word 2 <enter>
  748.  
  749.  
  750. (Note that the online help files are probably in the S: subdirectory if
  751. you have AmigaDOS 1.3 or older because the PROGDIR: feature is only
  752. supported starting with AmigaDOS 2.0. With this feature a program can
  753. see where the program executable is located. PowerVisor uses PROGDIR:
  754. to locate the online help files, the error file and the menu file)
  755.  
  756. You can also change the ²error file ¹PowerVisor-errors. Each line in
  757. this file must always be 70 bytes long (including the newline).
  758. The first line in the file corresponds with error -6.
  759.  
  760.  
  761. If you use the AmigaDOS 2.0 version of PowerVisor you can also use
  762. menus. All menus PowerVisor uses are in the ¹PowerVisor-menus file.
  763. Each line in this file has the following format (spaces are not
  764. important) :
  765.  
  766.    <command> [<title string> [<command string> [<shortcut>] ] ]
  767.  
  768. <command> is one of
  769.  
  770.    'title' for a menu titlebar
  771.    'item' for a menu item
  772.    'sub' for a sub item
  773.    'ibar' for a horizontal bar in an item menu
  774.    'sbar' for a horizontal bar in a sub menu
  775.    'end' to end the menus (is required)
  776.  
  777. The other strings are strings in the PowerVisor syntax. This means that
  778. you can use quotes (or MUST use quotes if there are spaces in the
  779. string or other special things not supported in names (see the 'Expressions'
  780. tutorial file)) or not (simple names).
  781.  
  782. The 'title' command only uses the <title string>
  783. The 'item' command uses the <title string> and if the item has no
  784.    sub menus the <command string> is also used
  785.    <shortcut> is optional
  786. The 'sub' item used the <title string> and the <command string>
  787.    <shortcut> is optional
  788. The other commands have no <title string>, <command string> or <shortcut>
  789.  
  790.  
  791. Example :
  792.  
  793. > title Project
  794. >    item 'About' 'print \'Hello world\\0a\''
  795. >    ibar
  796. >    item Quit quit Q
  797. >
  798. > title misc
  799. >    item 'Testing it' 'disp 1' '1'
  800. >    item 'Testing it 2' '{disp 1;disp 2}'
  801. >    item 'Sub menus'
  802. >       sub 'Sub 1' 'disp 1'
  803. >       sub 'Sub 2' 'disp 2' '2'
  804. > end
  805.  
  806.  
  807. ============================= Logical windows ================================
  808.  
  809. Although there are already a lot of logical window parameters you can set
  810. with the 'prefs' command, there can be times that you need more. See the
  811. 'Screen' chapter to see how you can open logical and physical windows.
  812.  
  813. Here is an example :
  814.  
  815. This sequence of commands opens two extra logical and physical windows
  816. and ¹tile them in a certain fashion :
  817.  
  818. Make the 'Main' physical window a ²non-backdrop window :
  819. < screen 0 <enter>
  820. Go to two bitplane mode and interlace :
  821. < mode fancy lace <enter>
  822. Open two physical windows and two logical windows :
  823. < openpw debug 0 0 500 200 <enter>
  824. < openpw rexx 500 0 140 200 <enter>
  825. < openlw debug debug 82 42 <enter>
  826. < openlw rexx rexx 80 40 <enter>
  827. Size the main physical window :
  828. < size main 640 200 <enter>
  829. < move main 0 200 <enter>
  830.  
  831.  
  832. ============================== And last ... ==================================
  833.  
  834. And last for the maximum flexibility... the 'PVCALL' command !
  835.  
  836. Note that this command is not for the casual user. It is also not for the
  837. experienced PowerVisor user. It is for the PowerVisor ¹wizard :-)  !!!
  838.  
  839. See the 'TheWizardCorner' file if you think you are a wizard.
  840.